Obsidian MCP Server 설치 가이드

Obsidian MCP Server를 설치하는 방법에는 수동 설치와 Smithery를 통한 설치 두 가지 방법이 있습니다. 이 가이드에서는 두 방법 모두 설명하겠습니다.

사전 요구사항

Obsidian MCP Server를 설치하기 전에 다음 항목이 필요합니다:

• Node.js 20 이상: 최신 LTS 버전이 권장됩니다.
• 기존 Obsidian 금고(vault): 서버가 접근할 Obsidian 금고가 필요합니다.

방법 1: 수동 설치 (권장)

수동 설치는 더 신뢰할 수 있는 방법으로, 설정 프로세스를 완전히 제어할 수 있습니다.

1. Claude Desktop 구성 파일 찾기

• macOS의 경우:

  ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows의 경우:

  %APPDATA%\Claude\claude_desktop_config.json

2. MCP 서버 구성 추가

구성 파일에 다음 내용을 추가합니다:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp", "/path/to/your/vault"]
    }
  }
}

3. 금고 경로 설정

/path/to/your/vault 부분을 실제 Obsidian 금고의 절대 경로로 교체하세요:

• macOS/Linux의 경우:

  /Users/username/Documents/MyVault

• Windows의 경우:

  C:\\Users\\username\\Documents\\MyVault

  (역슬래시 두 개에 유의하십시오)

4. 구성 파일 저장 및 Claude Desktop 재시작

변경 사항을 저장하고 Claude Desktop을 재시작하여 변경 사항을 적용합니다.

5. 연결 확인

재시작 후 Claude Desktop에 망치 아이콘이 나타나면 MCP 서버가 성공적으로 연결된 것입니다.

문제 해결

연결 문제가 발생하면 다음 위치에 있는 로그를 확인하세요:

• macOS:

  ~/Library/Logs/Claude/mcp*.log

• Windows:

  %APPDATA%\Claude\logs\mcp*.log

방법 2: Smithery를 통한 설치

Smithery를 통한 설치는 더 편리하지만, 수동 설치만큼 철저하게 테스트되지 않았습니다.

1. Smithery 명령어 실행

터미널에서 다음 명령어를 실행합니다:

npx -y @smithery/cli install obsidian-mcp --client claude

2. 구성 확인

설치 후 구성 파일을 열고 올바른 금고 경로를 가리키는지 확인합니다. 필요한 경우 금고 경로를 수정하세요.

다음 단계

설치가 완료되면 Obsidian MCP 활용 가이드를 참고하여 Obsidian MCP Server의 기능을 활용해 보세요.